/config/app/proxy/virtualIP//ipAddress

Set the IP address for the current virtual IP.

Use

Use to set the IP address or IP address range and port for the virtual IP. This designates the IP addresses that the system will accept traffic for.

Note: For most reverse proxy configurations, the IP address of each virtual IP must also be configured as an IP address on the data interface. If the IP address of the virtual IP is not also configured on a data interface, the system displays the following warning when you set the admin status to online: WARNING: virtual-ip test2 has ARP reply disabled until the IP address is configured on a system interface.

You can set either a specific IP address and port or a range of IP addresses for a specific port. The range includes both addresses you specify as the range start and end. A range cannot overlap any other range on the system for the same port.

If a virtual IP has a specific IP assigned to it that falls within the range of another virtual IP, the system sends all traffic to the virtual IP with the specific IP address.

Caution: When attaching a virtual IP to a forward proxy, the virtual IP must not include any of the system’s own IP addresses. For a virtual IP with a single IP address, do not set the virtual IP’s IP address to one of the system’s own IP addresses. For a virtual IP with a range of addresses, you must ensure that the IP address range does not contain any of the system’s own IP addresses. This may mean you need to break the virtual IP into multiple virtual IPs. See [Configuring a range for a virtual IP with forward proxy](htt ps://docs.lineratesystems.com/087Release_2.6/490kbase/Configuring_a_range_for_ a_virtual_IP_with_forward_proxy) for more detail and an example.

The system handles routed virtual IPs. Even if you set a large range of IP addresses for a virtual IP, the system only sends an ARP reply if an IP address in the range is configured on an interface. However, the system will accept traffic for any IP address in the range.

Parameters

name: Name of virtual IP

Data Key

The data key contains the IP address, family, and port.

Data Type

socket-addr

Default Data Value

NULL

Default Allowed

False

Request Methods

GET, PUT

Examples

GET

curl -b cookie.jar -k https://10.1.2.3:8443/lrs/api/v1.0/config/app/proxy/virtualIP/vip1/ipAddress

GET Response

{"/config/app/proxy/virtualIP/vip1/ipAddress": {"data": {"addr": "201.0.114.1",
                                                             "family": "af-inet",
                                                             "port": 20001},
                                                   "default": False,
                                                   "defaultAllowed": False,
                                                   "deleteAllowed": False,
                                                   "numChildren": 0,
                                                   "type": "socket-addr"},
 "httpResponseCode": 200,
 "recurse": False,
 "requestPath": "/config/app/proxy/virtualIP/vip1/ipAddress"}

PUT

curl -b cookie.jar –data @data.json -k -H “Content-Type: application/json” -X PUT https://10.1.2.3:8443/lrs/api/v1.0/config/app/proxy/virtualIP/vip1/ipAddress

PUT Response

{"httpResponseCode": 200,
  "requestPath": "/config/app/proxy/virtualIP/vip1/ipAddress",
  "recurse":false}
  1. /config/app/proxy/virtualIP//ipAddress 1. Parameters 2. Data Key
    1. Data Type
    2. Default Data Value 3. Default Allowed 4. Request Methods 5. Related 6. Examples